# 1.6 Tiled

Tiled is a server and data management system used to store and organise experimental data through a web API. It is run as a (mostly) centralised service. The RunEngine inserts bluesky documents directly into Tiled. At the moment, NeXus files are written from the messages published on the message bus. Tiled should contain the same information that is in the NeXus files but in due course, Tiled should be the one source of truth. 

## Configuration

An example configuration to enable tiled is shown in this `config.yaml` file. 

```{literalinclude} ../../tests/system_tests/config.yaml
:language: yaml
```

The options to configure Tiled are in the `TiledConfig` model which can be found in the [config.py file](../../src/blueapi/config.py). Apart from the url, the main aspect is authentication. This is either an ApiKey:

```
authentication: secret-key 
```

or service account details:

```
authentication:
    client_id: "client-id"
    client_secret: "secret"
    token_url: "url"
```

The values in the `config.yaml` are the default ones use if the user doesn't provide them.